ADDENDUM TO MACINTOSH™ VERSION 
OF ZBasic™ 3.01 


HARDWARE REQUIREMENTS: All but the 128K Macintosh. 
STARTING UP ZBasic™ 3.01: (Make Backup(s) first!) 


INTERNAL DRIVE: Start up your Macintosh with another SYSTEM diskette. Eject the SYSTEM disk and 
insert the ZBasic diskette. If you don't need EDIT you can copy the necessary files over ~ 
your SYSTEM diskette (ZBASIC, ZBASIC.HLP). 


OTHERS: Put the ZBasic diskette in the other drive and copy the ZBasic files over to the drive you 
want to use. 


NEW ADDITIONS 


The latest version of ZBasic has some new enhancements and additions that didn't make the third edition 
manual. Please add these additions to your manual: 





USING THE NEW MDS EDITOR (NEW ENHANCEMENT) 


Included with version 3.01 is a new Macintosh type editor called "EDIT". EDIT can be accessed either direcuy 
from the finder by double clicking the EDIT icon or from ZBasic under the EDIT window as "MDS EDIT". The 
file you are using will be passed to ZBasic (and visa-versa) automatically. 


To return to ZBasic from EDIT just select ZBasic from the TRANSFER menu. 





KEYWORDS IN VARIABLES r 
The manual was unclear as to how to use keywords in variables like Mbasic™ does. To do this make sure you 
use spaces between keywords and then select "RE-CONFIGURE ZBASIC” under the CONFIGURE menu. Set 
"SPACE REQUIRED AFTER KEYWORD" to YES. Thereafter keywords may be embedded in variables. Be s.- 
to put spaces between keywords (like Mbasic™ needs) or confusion may arise as to what are variables and what 
are keywords (Note: Not compatible with other versions of ZBasic™). 





WINDOW OFF (NEW STATEMENT) 
Format WINDOW OFF 


DEFINITION Disables the default window in the standalone application. Note that MOUSE and EDIT FIELD etc., do not worn 
with the default window (for run time applications only). 





MACINTALK™ 


The appendix was unclear about how to get Macintalk to actually talk. This simple program should make it 
Clearer: 


OPEN TALK,-1,"",512 

TALK #-1, 150,110,0 

PRINT#-1, “HELLO THERE. I AM MACINTALK" 
CLOSE#-1 


'URSOR (NEW STATEMENT) f 
urmat CURSOR=n 


‘EFINITION Allows the user to change the cursor to some commonly used types: 


n=0 Standard arrow cursor 

n-1 I Beam cursor for text editing (like Macwrite text cursor) 
n=2 Cross Hair (+) cursor for some graphic needs. 

n=3 Plus sign cursor ( <> ) for SpreadSheets etc. 

n=4 Standard Wrist Watch cursor tells user to wait. 


————————— eee 
fANDARD FILES DIALOG BOX (NEW ROUTINE) 


his routine brings up the standard file query box window: SAVE CHANGES BEFORE CLOSING? 


10 A&=FN GETNEWDIALOG (132,@,-1) 
20 CALL MODALDIALOG (Ø, ITEM%) 
30 CALL DISPOSDIALOG(A&) 


esult of ITEM% determines the users Tesponse:- 


ITEM%=1 YES 
ITEM%=2 NO 
ITEM%=3 CANCEL 


SING PATTERNS WITH GRAPHICS 

© designate the patterns for filling circles or boxes or for lines used with PLOT use: 
PEN core Ot 

here n is a number that designates one of the following patterns: 


cee ee Boe et g 9 10 11 12 13 14 15 16 17 18 19 
ES iii INNES eS BRR Ss ess es ot 
EYE AER RE RS Raa oi oe: 
20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 
pe ae a a a 


ZNDING CONTROL CHARACTERS TO AN IMAGEWRITER™ 
Because ZBasic sends text to be printed with LPRINT or LLIST to the Macintosh™ printer driver, control codes 


and other codes may be stripped out. To by-pass the Macintosh printer driver and to send control codes out to the 
Imagewriter™ use OPEN"C", 
















OPEN"C™, n , 9600 

PRINT# n, "TEXT..." or CHRS(x) or Variables... 
CLOSE#n 

REM (n=-1 for modem port, n=-2 for printer port) 


ee 


‘NDING CONTROL CODES TO A LASERWRITER™ 
This is more complicated than the Imagewriter™ and you must have knowledge of POSTSCRIPT™ to do this 
properly. First get a modem eliminator cable. Set the Laserwriter™ for 9600 baud (next to where the cable is 
connected there is a dial for Appletalk, Special, 9600 and serial---Set it to 9600). OPEN C as above with the 
Imagewriter. Send code out as described by POSTSCRIPT™. 


USE AT YOUR OWN RISK! 
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ZBasic 


Interactive BASIC 
Compiler 





ADDENDUM TO ZBasic™ 
UPGRADE VERSION 3.01 


Dear ZBasic™ Customer, 


Thank you for buying ZBasic for the Macintosh™. As usually happens with first releases 
of software products as complicated as ZBasic, some problems creep in that even 
professional Beta Testers miss. The initial release had some problems that this free upgrade 
will alleviate. We've also added a few things to make it easier to use. 


This free diskette contains the newest release; ZBasic 3.01. You will be happy to know 
that the problems with the Edit window have been fixed. We have also added a new 
sophisticated Mac Type editor for your use that allows find-and-replace and more. It's the 
same one Apple uses with its MDS and it's on this upgrade diskette (called EDIT). It's fast 
and easy to use and links with ZBasic for fast editing (you can still use the Edit window or 
Command window for quick fixes and debugging). 


Be sure to DESTROY old copies of ZBasic™ 3.00. Copy over the new programs. The 
ZBasic "HELP" file and window have been revised and are easier to read and understand . 
Type HELP | for the main menu and HELP 100 for the Macintosh special menu. 


There have been some bug fixes in the new release as well. You will find this version much 
easier to use and a little faster. 


We thank all of you for your patience and send a special thanks to all of you that were kind 
enough to bring problems to our attention. I think you will find the new ZBasic the finest 
BASIC available for the Macintosh (or IBM PC or Apple // or CP/M-80 or...). 


Watch for new optional offerings coming soon like a Hi-Speed Floating Point SANE math 
package, BTREE support and more. 


Sincerely, 


Michael A. Gariepy 
Chairman 
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FIXES AND NOTES 
TO ZBasic™ 3.01 


EDIT WINDOW 
The ZBasic EDIT WINDOW problems have been fixed. The scroll bar will now auto-repeat and 
extraneous characters will no longer appear. It is very useful for quick editing when in interactive mode. 


When major changes need to made you may want to transfer to MDS EDIT. 





EVENT TRAPPING 


Event trapping, like EDIT FIELDS, BUTTONS, MOUSE, SCROLL BUTTONS etc., must be done 
within a window you create. The default window will not return results of events correctly. Simply open 
a window with the window statement : WINDOW 1,"WINDOW",,1, 





DEFAULT WINDOW 
The default window is used for making other ZBasic programs being ported over to the Macintosh easily 
portable. It should not be used with Macintosh type programs. To eliminate this window use the new 
command; WINDOW OFF on the first line of the program. This is a compile time directive and 
allows you to rid your programs of this window. 





EDIT FIELD 
We have sped up and cleaned up the EDIT FIELD commands. 





<RETURN> OR <ENTER> NOW OK 
Either key is now OK for INPUT or LINEINPUT 





<OPTION C> or <COMMAND PERIOD> 


The break keys are now interchangeable. Use either for most things but only COMMAND PERIOD for 
BREAK. 





APPLICATIONS 
Double click applications with events will now execute properly. 





MOUSE 
The Click and Drag functions of MOUSE(0) have been fixed. MOUSE functions will only operate 
properly under windows you create---NOT the Default window. 





KEYWORDS IN VARIABLES 
The manual was unclear as to how to use keywords in variables like Mbasic™. To do this make sure 
you use spaces between keywords, like Mbasic™, and then select "RE-~CONFIGURE ZBASIC” under 
the CONFIGURE menu. Set “SPACE REQUIRED AFTER KEYWORD" to YES. Thereafter keywords 
may be embedded in variables like Mbasic™. Be sure to put spaces between keywords ( like MBasic 
needs) or confusion may arise as to what are variables and what are keywords. 





| 
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CHANGES TO THE 
ZBasic™ MACINTOSH™ APPENDIX 


Following are changes or additions to the Macintosh Appendix. Makes notes in the Mac Appendix 
where needed. 


NEW MANUAL 
There is a new manual available that has these fixes. The new manual is 615 pages and contains the 
revised Macintosh Appendix (and MS-DOS and others) and the main manual all in one. It has been 
edited and is much easier to read and use. It is being offered to existing users for only $9.95 - $5.00 
shipping and handling (regularly $49.95). 





USING THE NEW MDS EDITOR (NEW ENHANCEMENT) | 
Included with version 3.01 is a new Macintosh type editor called "EDIT". EDIT can be accessed either 
directly from the finder by double clicking the EDIT icon or from ZBasic under the EDIT window as 
“MDS EDIT". The file you are using will passed automatically if in memory. | 


To retum to ZBasic from EDIT just select ZBasic from the TRANSFER menu. | 





FILES$ (ERROR IN THE MACINTOSH APPENDIX) 
On page 67 and 68 in the Macintosh Appendix, the syntax for FILES(1, is incorrect. The correct syntax 
is FILES$(1,["typelist"[,[, volume%]}}). The problem was that the second comma is needed after “type 
list” or an error was generated. 





PRCANCEL FUNCTION (NEW FUNCTION) 
Format PRCANCEL 


DEFINITION When PRCANCEL returns true (non zero), the user has pressed the CANCEL button in the DEF 
LPRINT dialog box. This means the user wants to cancel printing and you should abort the print 
routine. 


EXAMPLE DEFLPRINT 
IF PRCANCEL<>® THEN RETURN 
Printing starts here... 





WINDOW OFF (NEW STATEMENT) 
rormatT WINDOW OFF 


DEFINITION Disables the default window in the standalone application. Note that MOUSE and EDIT FIELD etc.. du 
not work with the default window. 





RUN filename (NEW STATEMENT) 
This version of ZBasic allows you to RUN another application from within an application using this 
syntax. 


ae 
{ 
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a ee eee 
MACINTALK™ 
The appendix was unclear about how to get Macintalk to actually talk. This simple program should 
make it clearer: 


OPEN TALK,-1,"",512 

TALK #-1, 150,110,0 

PRINT#-1, "HELLO THERE. I AM MACINTALK" 
CLOSE#-1 


ee 
ENHANCEMENTS TO OPEN "cC" 





FORMAT OPEN "C", -I or -2 [,{baud]|{parity}[,[stopbit]{ word length), [buffer}]]] 
DEFINITION Enhancements to the standard ZBasic statement include: 


-d Modem port 
2 Printer port 
baud Up to 19,200 and possibly 57,600 baud for some 


applications. buffer may need to be set larger for higher 
baud rates. 


stopbit 2=1.5 stop bits 


word length 25 bits 
3=6 bits 


buffer This version adds the “buffer” enhancement. 
Default buffer length is 64 bytes. Minimum buffer 
length is 1 byte. Maximum length is 32,767 bytes. 


REMARK See Reference section for more information about OPEN "C" and some example terminal programs and 
file transfer programs. 

a O 

NEW TRACE FUNCTION TO PRINTER 

Format TRON#128 


DEFINITION This statement is an enhancement to the standard TRON but instead of all line number trace output 
going to the screen, it is routed to the printer for debugging without disturbing screen output. 

— 

CURSOR (NEW STATEMENT) 





Format CURSOR=n 
DEFINITION Allows the user to change the cursor to some commonly used types: 


n=0 Standard arrow cursor 
n-1 I Beam cursor for text editing (like Macwrite text cursor) 7 


n=2 Cross Hair (+) cursor 
n=3 Plus sign cursor ( + ) 
n=4 Standard Wrist Watch cursor 


( 
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STANDARD FILES DIALOG BOX (NEW ROUTINE) 
This routine brings up the standard file query box window: SAVE CHANGES BEFORE CLOSING? 
10 A&=FN GETNEWDIALOG (132,@,-1) 
20 CALL MODALDIALOG (Ø, ITEM$) 
30 CALL DISPOSDIALOG(Aé) 
Result of ITEM% determines the users response: 
ITEM%=1 YES 


ITEM%=-2 NO 
ITEM%=3 CANCEL 





SENDING CONTROL CHARACTERS TO AN IMAGEWRITER™ 
Because ZBasic sends text to be printed with LPRINT or LLIST to the Macintosh™ printer driver, 
control codes and other codes may be stripped out. To by-pass the Macintosh printer driver and to send 
control codes out the Imagewriter™ using OPEN"C”. 


OPEN"C", n , 9600 

PRINT# n, “TEXT...” or CHRS$(x) or Variables... 
CLOSE#n 

REM (n=-1 for modem port, n=-2 for printer port) 





SENDING CONTROL CODES TO A LASERWRITER™ 
This is more complicated than the Imagewriter™ and you must have knowledge of POSTSCRIPT™ to 
do this properly. First get a modem eliminator cable. Set the Laserwriter™ for 9600 baud (next to where 
the cable is connected there is a dial for Appletalk, Special, 9600 and serial---Set it to 9600). OPEN C 
as above with the Imagewriter. Send code out as described by POSTSCRIPT™. 


USE AT YOUR OWN RISK! 
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CREATING AN APPLICATION ICON AND PASSING DATA TO 
YOUR APPLICATION FROM A ZBASIC FILE 


The Macintosh appendix was unclear about how to create icons for a stand-alone application. (ZBasic uses the 
standard Macintosh application icon with the hand and paper and pencil with RUN* if RMaker or another Icon 
Editor is not used). This example should make it easier to understand. This sequence is primarily of 
importance to those marketing their products. 


1. Write your program in the editor of choice. If you wish to have your application loaded when a user selects 
files created from your application (from the Finder), use DEFOPEN “ttttcccc” to set your file type (tttt) and 
CREATOR (cccc). 


See the program on the ZBasic disk called DISKIO.BAS for examples of doing this. 


2. If your application is going to have its own ICONS, create an RMaker source file using a text editor or word 
Processor such as MacWrite. The RMaker source for the DISKIO.BAS program is included on the ZBasic disk 
and is called DISKIO.R. Be sure it includes the Icon list, File Reference and Bundle Resources and version 
data in the Source file or in Resource Files included with the Directive for RMaker. The Resource type of 
your version data must be the same as the CREATOR of your application. Examples of how to create each 
type are included in the DISKIO.R file. 


3. In the ZBasic Command Window, use the CREATOR command to set the Applications "Creator". For 
example, in the Command Window type: 


CREATOR "cece" 


Where "ccce" is the creator type for your application. In the DISKIO.BAS example, the creator type is 
“DTST’. 


4. If your application is going to have its own icon and icons for its own file types, use the BUNDLE command 
from the Command Window so that ZBasic will set the Bundle Bit in the Files’ Finder information. Simply 
type: 


BUNDLE 1 


5. Compile and save your application using RUN*. ZBasic will prompt you for the filename and the 
application will then be written to the disk (just double click it to execute). 


6. Exit from ZBasic to Rmaker. Select the APPLICATION R file for your new application and then open it. 
RMaker will then compile and add resources to your file. à 


7. Quit RMaker to the Finder. If everything was done properly, your application will have its own icon 
displayed on the Desktop. If it does not, check to be sure you have included all the resource types included in 
the DISKIO.R example file (included on the ZBasic disk). 


